<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>I18N::Charset - IANA Character Set Registry names and Unicode::MapUTF8 (et al.) conversion scheme names - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of I18N-Charset - MetaCPAN" href="https://metacpan.org/dist/I18N-Charset/releases.rss" />
        <link rel="canonical" href="./I18N::Charset.html" />
        <meta name="description" content="IANA Character Set Registry names and Unicode::MapUTF8 (et al.) conversion scheme names" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/I18N::Charset" />
<meta name="twitter:title"       content="I18N::Charset" />
<meta name="twitter:description" content="IANA Character Set Registry names and Unicode::MapUTF8 (et al.) conversion scheme names" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./I18N::Charset.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of I18N-Charset was released.">
      <span class="relatize">02 Feb 2021 18:33:02 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/I18N-Charset">I18N-Charset</a>
  </li>
  <li>
    Module version: 1.419
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/I18N-Charset/source/lib/I18N/Charset.pm">Source</a>
    (<a href="https://metacpan.org/dist/I18N-Charset/source/lib/I18N/Charset.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/I18N-Charset/source/lib/I18N">Browse</a>
    (<a href="https://metacpan.org/dist/I18N-Charset/source/lib/I18N?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/I18N-Charset/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/I18N-Charset/contribute">How to Contribute</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=I18N-Charset">Issues</a>
      (0)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=I18N-Charset+1.419" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/I/I18N-Charset.html?oncpan=1&amp;distmat=1&amp;version=1.419&amp;grade=2" style="color: #090">605</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/I/I18N-Charset.html?oncpan=1&amp;distmat=1&amp;version=1.419&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/I/I18N-Charset.html?oncpan=1&amp;distmat=1&amp;version=1.419&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/MTHURN/I18N-Charset-1.419">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on I18N-Charset who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 0
      </div>
    </li>
    <li>
      License: perl_5
    </li>
    <li>
      Perl: v5.5.0
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/I18N-Charset/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/M/MT/MTHURN/I18N-Charset-1.419.tar.gz">
      Download (<span itemprop="fileSize">46.04KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FMTHURN%2FI18N-Charset-1.419%2Flib%2FI18N%2FCharset.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/I18N-Charset/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/I18N-Charset/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:I18N-Charset">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="I18N-Charset">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/I18N/Charset.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="MTHURN/I18N-Charset-1.419"
>1.419
  (MTHURN on 2021-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.418"
>1.418
  (MTHURN on 2018-11-24)</option>
<optgroup label="BackPAN">'
<option
  
  value="MTHURN/I18N-Charset-1.417"
>1.417
  (MTHURN on 2017-04-30)</option>
<option
  
  value="MTHURN/I18N-Charset-1.415"
>1.415
  (MTHURN on 2016-06-18)</option>
<option
  
  value="MTHURN/I18N-Charset-1.414"
>1.414
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.413"
>1.413
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.412"
>1.412
  (MTHURN on 2013-10-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.411"
>1.411
  (MTHURN on 2013-03-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.409"
>1.409
  (MTHURN on 2013-03-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.407"
>1.407
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.405"
>1.405
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.404"
>1.404
  (MTHURN on 2013-01-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.403"
>1.403
  (MTHURN on 2013-01-14)</option>
<option
  
  value="MTHURN/I18N-Charset-1.402"
>1.402
  (MTHURN on 2012-10-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.401"
>1.401
  (MTHURN on 2011-11-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.397"
>1.397
  (MTHURN on 2011-09-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.396"
>1.396
  (MTHURN on 2010-11-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.395"
>1.395
  (MTHURN on 2010-09-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.394"
>1.394
  (MTHURN on 2008-07-12)</option>
<option
  
  value="MTHURN/I18N-Charset-1.392"
>1.392
  (MTHURN on 2008-07-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.391"
>1.391
  (MTHURN on 2008-06-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1.389"
>1.389
  (MTHURN on 2008-05-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.388"
>1.388
  (MTHURN on 2008-02-21)</option>
<option
  
  value="MTHURN/I18N-Charset-1.387"
>1.387
  (MTHURN on 2008-02-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.386"
>1.386
  (MTHURN on 2008-02-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.385"
>1.385
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.383"
>1.383
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.382"
>1.382
  (MTHURN on 2006-12-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.379"
>1.379
  (MTHURN on 2005-11-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.375"
>1.375
  (MTHURN on 2004-10-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.371"
>1.371
  (MTHURN on 2004-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.37"
>1.37
  (MTHURN on 2004-01-31)</option>
<option
  
  value="MTHURN/I18N-Charset-1.36"
>1.36
  (MTHURN on 2004-01-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.35"
>1.35
  (MTHURN on 2004-01-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.24"
>1.24
  (MTHURN on 2003-03-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.23"
>1.23
  (MTHURN on 2002-10-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.22"
>1.22
  (MTHURN on 2002-10-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.21"
>1.21
  (MTHURN on 2002-09-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.19"
>1.19
  (MTHURN on 2002-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.18"
>1.18
  (MTHURN on 2002-08-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.17"
>1.17
  (MTHURN on 2002-05-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.16"
>1.16
  (MTHURN on 2002-04-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.15"
>1.15
  (MTHURN on 2002-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.13"
>1.13
  (MTHURN on 2002-01-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.12"
>1.12
  (MTHURN on 2001-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.11"
>1.11
  (MTHURN on 2001-08-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.09"
>1.09
  (MTHURN on 2001-06-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.08"
>1.08
  (MTHURN on 2001-04-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.07"
>1.07
  (MTHURN on 2001-03-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.06"
>1.06
  (MTHURN on 2001-03-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.05"
>1.05
  (MTHURN on 2001-01-08)</option>
<option
  
  value="MTHURN/I18N-Charset-1.04"
>1.04
  (MTHURN on 2000-09-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.03"
>1.03
  (MTHURN on 1999-07-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1_02"
>1_02
  (MTHURN on 1998-07-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1_01"
>1_01
  (MTHURN on 1998-07-27)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/MTHURN/I18N-Charset-1.419/diff/' + encodeURIComponent(this.value) + '/lib/I18N/Charset.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="MTHURN/I18N-Charset-1.419"
>1.419
  (MTHURN on 2021-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.418"
>1.418
  (MTHURN on 2018-11-24)</option>
<optgroup label="BackPAN">'
<option
  
  value="MTHURN/I18N-Charset-1.417"
>1.417
  (MTHURN on 2017-04-30)</option>
<option
  
  value="MTHURN/I18N-Charset-1.415"
>1.415
  (MTHURN on 2016-06-18)</option>
<option
  
  value="MTHURN/I18N-Charset-1.414"
>1.414
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.413"
>1.413
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.412"
>1.412
  (MTHURN on 2013-10-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.411"
>1.411
  (MTHURN on 2013-03-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.409"
>1.409
  (MTHURN on 2013-03-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.407"
>1.407
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.405"
>1.405
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.404"
>1.404
  (MTHURN on 2013-01-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.403"
>1.403
  (MTHURN on 2013-01-14)</option>
<option
  
  value="MTHURN/I18N-Charset-1.402"
>1.402
  (MTHURN on 2012-10-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.401"
>1.401
  (MTHURN on 2011-11-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.397"
>1.397
  (MTHURN on 2011-09-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.396"
>1.396
  (MTHURN on 2010-11-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.395"
>1.395
  (MTHURN on 2010-09-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.394"
>1.394
  (MTHURN on 2008-07-12)</option>
<option
  
  value="MTHURN/I18N-Charset-1.392"
>1.392
  (MTHURN on 2008-07-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.391"
>1.391
  (MTHURN on 2008-06-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1.389"
>1.389
  (MTHURN on 2008-05-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.388"
>1.388
  (MTHURN on 2008-02-21)</option>
<option
  
  value="MTHURN/I18N-Charset-1.387"
>1.387
  (MTHURN on 2008-02-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.386"
>1.386
  (MTHURN on 2008-02-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.385"
>1.385
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.383"
>1.383
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.382"
>1.382
  (MTHURN on 2006-12-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.379"
>1.379
  (MTHURN on 2005-11-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.375"
>1.375
  (MTHURN on 2004-10-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.371"
>1.371
  (MTHURN on 2004-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.37"
>1.37
  (MTHURN on 2004-01-31)</option>
<option
  
  value="MTHURN/I18N-Charset-1.36"
>1.36
  (MTHURN on 2004-01-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.35"
>1.35
  (MTHURN on 2004-01-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.24"
>1.24
  (MTHURN on 2003-03-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.23"
>1.23
  (MTHURN on 2002-10-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.22"
>1.22
  (MTHURN on 2002-10-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.21"
>1.21
  (MTHURN on 2002-09-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.19"
>1.19
  (MTHURN on 2002-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.18"
>1.18
  (MTHURN on 2002-08-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.17"
>1.17
  (MTHURN on 2002-05-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.16"
>1.16
  (MTHURN on 2002-04-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.15"
>1.15
  (MTHURN on 2002-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.13"
>1.13
  (MTHURN on 2002-01-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.12"
>1.12
  (MTHURN on 2001-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.11"
>1.11
  (MTHURN on 2001-08-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.09"
>1.09
  (MTHURN on 2001-06-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.08"
>1.08
  (MTHURN on 2001-04-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.07"
>1.07
  (MTHURN on 2001-03-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.06"
>1.06
  (MTHURN on 2001-03-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.05"
>1.05
  (MTHURN on 2001-01-08)</option>
<option
  
  value="MTHURN/I18N-Charset-1.04"
>1.04
  (MTHURN on 2000-09-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.03"
>1.03
  (MTHURN on 1999-07-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1_02"
>1_02
  (MTHURN on 1998-07-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1_01"
>1_01
  (MTHURN on 1998-07-27)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><i class="ttip" title="dynamic_config enabled">unknown</i></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/I18N::Charset/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=I18N%3A%3ACharset">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=I18N-Charset">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/MTHURN/I18N-Charset-1.419/view/lib/I18N/Charset.pm">This version</a>
    </li>
    <li>
      <a href="./I18N::Charset.html">Latest version</a>
    </li>
    <li>
    </li>
    <li>
<div id="metacpan_contributors">
  <div>
    <button class="btn-link"
      onclick="$(this).hide(); $('#metacpan_contributors ul').slideDown(); return false;"
    >and 1 contributors</button>
  </div>
  <ul style="display: none">
    <li class="contributor"
    >
      Martin &#39;Kingpin&#39; Thurn, C&lt;mthurn at cpan.org&gt;, L&lt;http://tinyurl.com/nn67z&gt;.
    </li>
  </ul>
</div>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/MTHURN" class="author-name">Martin &#39;Kingpin&#39; Thurn</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/I18N/Charset.pm&#39;" class="">
<option
  selected
  value="MTHURN/I18N-Charset-1.419"
>1.419
  (MTHURN on 2021-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.418"
>1.418
  (MTHURN on 2018-11-24)</option>
<optgroup label="BackPAN">'
<option
  
  value="MTHURN/I18N-Charset-1.417"
>1.417
  (MTHURN on 2017-04-30)</option>
<option
  
  value="MTHURN/I18N-Charset-1.415"
>1.415
  (MTHURN on 2016-06-18)</option>
<option
  
  value="MTHURN/I18N-Charset-1.414"
>1.414
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.413"
>1.413
  (MTHURN on 2015-02-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.412"
>1.412
  (MTHURN on 2013-10-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.411"
>1.411
  (MTHURN on 2013-03-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.409"
>1.409
  (MTHURN on 2013-03-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.407"
>1.407
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.405"
>1.405
  (MTHURN on 2013-01-26)</option>
<option
  
  value="MTHURN/I18N-Charset-1.404"
>1.404
  (MTHURN on 2013-01-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.403"
>1.403
  (MTHURN on 2013-01-14)</option>
<option
  
  value="MTHURN/I18N-Charset-1.402"
>1.402
  (MTHURN on 2012-10-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.401"
>1.401
  (MTHURN on 2011-11-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.397"
>1.397
  (MTHURN on 2011-09-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.396"
>1.396
  (MTHURN on 2010-11-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.395"
>1.395
  (MTHURN on 2010-09-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.394"
>1.394
  (MTHURN on 2008-07-12)</option>
<option
  
  value="MTHURN/I18N-Charset-1.392"
>1.392
  (MTHURN on 2008-07-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.391"
>1.391
  (MTHURN on 2008-06-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1.389"
>1.389
  (MTHURN on 2008-05-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.388"
>1.388
  (MTHURN on 2008-02-21)</option>
<option
  
  value="MTHURN/I18N-Charset-1.387"
>1.387
  (MTHURN on 2008-02-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.386"
>1.386
  (MTHURN on 2008-02-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.385"
>1.385
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.383"
>1.383
  (MTHURN on 2007-05-17)</option>
<option
  
  value="MTHURN/I18N-Charset-1.382"
>1.382
  (MTHURN on 2006-12-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.379"
>1.379
  (MTHURN on 2005-11-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.375"
>1.375
  (MTHURN on 2004-10-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.371"
>1.371
  (MTHURN on 2004-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.37"
>1.37
  (MTHURN on 2004-01-31)</option>
<option
  
  value="MTHURN/I18N-Charset-1.36"
>1.36
  (MTHURN on 2004-01-25)</option>
<option
  
  value="MTHURN/I18N-Charset-1.35"
>1.35
  (MTHURN on 2004-01-16)</option>
<option
  
  value="MTHURN/I18N-Charset-1.24"
>1.24
  (MTHURN on 2003-03-28)</option>
<option
  
  value="MTHURN/I18N-Charset-1.23"
>1.23
  (MTHURN on 2002-10-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.22"
>1.22
  (MTHURN on 2002-10-02)</option>
<option
  
  value="MTHURN/I18N-Charset-1.21"
>1.21
  (MTHURN on 2002-09-05)</option>
<option
  
  value="MTHURN/I18N-Charset-1.19"
>1.19
  (MTHURN on 2002-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.18"
>1.18
  (MTHURN on 2002-08-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1.17"
>1.17
  (MTHURN on 2002-05-01)</option>
<option
  
  value="MTHURN/I18N-Charset-1.16"
>1.16
  (MTHURN on 2002-04-15)</option>
<option
  
  value="MTHURN/I18N-Charset-1.15"
>1.15
  (MTHURN on 2002-02-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.13"
>1.13
  (MTHURN on 2002-01-10)</option>
<option
  
  value="MTHURN/I18N-Charset-1.12"
>1.12
  (MTHURN on 2001-09-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.11"
>1.11
  (MTHURN on 2001-08-24)</option>
<option
  
  value="MTHURN/I18N-Charset-1.09"
>1.09
  (MTHURN on 2001-06-04)</option>
<option
  
  value="MTHURN/I18N-Charset-1.08"
>1.08
  (MTHURN on 2001-04-19)</option>
<option
  
  value="MTHURN/I18N-Charset-1.07"
>1.07
  (MTHURN on 2001-03-07)</option>
<option
  
  value="MTHURN/I18N-Charset-1.06"
>1.06
  (MTHURN on 2001-03-06)</option>
<option
  
  value="MTHURN/I18N-Charset-1.05"
>1.05
  (MTHURN on 2001-01-08)</option>
<option
  
  value="MTHURN/I18N-Charset-1.04"
>1.04
  (MTHURN on 2000-09-13)</option>
<option
  
  value="MTHURN/I18N-Charset-1.03"
>1.03
  (MTHURN on 1999-07-09)</option>
<option
  
  value="MTHURN/I18N-Charset-1_02"
>1_02
  (MTHURN on 1998-07-29)</option>
<option
  
  value="MTHURN/I18N-Charset-1_01"
>1_01
  (MTHURN on 1998-07-27)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/I18N-Charset">I18N-Charset-1.419</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage one &#10;
          • 4 direct dependents &#10;          • 6 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="I18N-Charset-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="I18N-Charset-1.419">
    <input type="hidden" name="author" value="MTHURN">
    <input type="hidden" name="distribution" value="I18N-Charset">
    <button type="submit" class="favorite"><span></span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./I18N::Charset.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite">
<span></span> ++</a>
</div>
   / <span>I18N::Charset</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./I18N::Charset.html#NAME">NAME</a></li>
  <li><a href="./I18N::Charset.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./I18N::Charset.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./I18N::Charset.html#CONVERSION-ROUTINES">CONVERSION ROUTINES</a></li>
  <li><a href="./I18N::Charset.html#QUERY-ROUTINES">QUERY ROUTINES</a></li>
  <li><a href="./I18N::Charset.html#CHARACTER-SET-NAME-ALIASING">CHARACTER SET NAME ALIASING</a></li>
  <li><a href="./I18N::Charset.html#KNOWN-BUGS-AND-LIMITATIONS">KNOWN BUGS AND LIMITATIONS</a></li>
  <li><a href="./I18N::Charset.html#SEE-ALSO">SEE ALSO</a></li>
  <li><a href="./I18N::Charset.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./I18N::Charset.html#LICENSE">LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>I18N::Charset - IANA Character Set Registry names and Unicode::MapUTF8 (et al.) conversion scheme names</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>  use I18N::Charset;

  $sCharset = iana_charset_name(&#39;WinCyrillic&#39;);
  # $sCharset is now &#39;windows-1251&#39;
  $sCharset = umap_charset_name(&#39;Adobe DingBats&#39;);
  # $sCharset is now &#39;ADOBE-DINGBATS&#39; which can be passed to Unicode::Map-&gt;new()
  $sCharset = map8_charset_name(&#39;windows-1251&#39;);
  # $sCharset is now &#39;cp1251&#39; which can be passed to Unicode::Map8-&gt;new()
  $sCharset = umu8_charset_name(&#39;x-sjis&#39;);
  # $sCharset is now &#39;sjis&#39; which can be passed to Unicode::MapUTF8-&gt;new()
  $sCharset = libi_charset_name(&#39;x-sjis&#39;);
  # $sCharset is now &#39;MS_KANJI&#39; which can be passed to `iconv -f $sCharset ...`
  $sCharset = enco_charset_name(&#39;Shift-JIS&#39;);
  # $sCharset is now &#39;shiftjis&#39; which can be passed to Encode::from_to()

  I18N::Charset::add_iana_alias(&#39;my-japanese&#39; =&gt; &#39;iso-2022-jp&#39;);
  I18N::Charset::add_map8_alias(&#39;my-arabic&#39; =&gt; &#39;arabic7&#39;);
  I18N::Charset::add_umap_alias(&#39;my-hebrew&#39; =&gt; &#39;ISO-8859-8&#39;);
  I18N::Charset::add_libi_alias(&#39;my-sjis&#39; =&gt; &#39;x-sjis&#39;);
  I18N::Charset::add_enco_alias(&#39;my-japanese&#39; =&gt; &#39;shiftjis&#39;);</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>The <code>I18N::Charset</code> module provides access to the IANA Character Set Registry names for identifying character encoding schemes. It also provides a mapping to the character set names used by the Unicode::Map and Unicode::Map8 modules.</p>

<p>So, for example, if you get an HTML document with a META CHARSET=&quot;...&quot; tag, you can fairly quickly determine what Unicode::MapXXX module can be used to convert it to Unicode.</p>

<p>If you don&#39;t have the module Unicode::Map installed, the umap_ functions will always return undef. If you don&#39;t have the module Unicode::Map8 installed, the map8_ functions will always return undef. If you don&#39;t have the module Unicode::MapUTF8 installed, the umu8_ functions will always return undef. If you don&#39;t have the iconv library installed, the libi_ functions will always return undef. If you don&#39;t have the Encode module installed, the enco_ functions will always return undef.</p>

<h1 id="CONVERSION-ROUTINES"><a id="CONVERSION"></a>CONVERSION ROUTINES</h1>

<p>There are four main conversion routines: <code>iana_charset_name()</code>, <code>map8_charset_name()</code>, <code>umap_charset_name()</code>, and <code>umu8_charset_name()</code>.</p>

<dl>

<dt id="iana_charset_name()"><a id="iana_charset_name"></a>iana_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set and returns a string which contains the official IANA name of the character set identified. If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the string are not important.</p>

<pre><code>    $sCharset = iana_charset_name(&#39;WinCyrillic&#39;);</code></pre>

</dd>
<dt id="mime_charset_name()"><a id="mime_charset_name"></a>mime_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set and returns a string which contains the preferred MIME name of the character set identified. If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the string are not important.</p>

<pre><code>    $sCharset = mime_charset_name(&#39;Extended_UNIX_Code_Packed_Format_for_Japanese&#39;);</code></pre>

</dd>
<dt id="enco_charset_name()"><a id="enco_charset_name"></a>enco_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set and returns a string which contains a name of the character set suitable to be passed to the Encode module. If no valid character set name can be identified, or if Encode is not installed, then <code>undef</code> will be returned. The case and punctuation within the string are not important.</p>

<pre><code>    $sCharset = enco_charset_name(&#39;Extended_UNIX_Code_Packed_Format_for_Japanese&#39;);</code></pre>

</dd>
<dt id="libi_charset_name()"><a id="libi_charset_name"></a>libi_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set and returns a string which contains a name of the character set suitable to be passed to iconv. If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the string are not important.</p>

<pre><code>    $sCharset = libi_charset_name(&#39;Extended_UNIX_Code_Packed_Format_for_Korean&#39;);</code></pre>

</dd>
<dt id="mib_to_charset_name">mib_to_charset_name</dt>
<dd>

<p>This function takes a string containing the MIBenum of a character set and returns a string which contains a name for the character set. If the given MIBenum does not correspond to any character set, then <code>undef</code> will be returned.</p>

<pre><code>    $sCharset = mib_to_charset_name(&#39;3&#39;);</code></pre>

</dd>
<dt id="mib_charset_name">mib_charset_name</dt>
<dd>

<p>This is a synonum for mib_to_charset_name</p>

</dd>
<dt id="charset_name_to_mib">charset_name_to_mib</dt>
<dd>

<p>This function takes a string containing the name of a character set in almost any format and returns a MIBenum for the character set. For IANA-registered character sets, this is the IANA-registered MIB. For non-IANA character sets, this is an unambiguous unique string whose only use is to pass to other functions in this module. If no valid character set name can be identified, then <code>undef</code> will be returned.</p>

<pre><code>    $iMIB = charset_name_to_mib(&#39;US-ASCII&#39;);</code></pre>

</dd>
<dt id="map8_charset_name()"><a id="map8_charset_name"></a>map8_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set (in almost any format) and returns a string which contains a name for the character set that can be passed to Unicode::Map8::new(). Note: the returned string will be capitalized just like the name of the .bin file in the Unicode::Map8::MAPS_DIR directory. If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the argument string are not important.</p>

<pre><code>    $sCharset = map8_charset_name(&#39;windows-1251&#39;);</code></pre>

</dd>
<dt id="umap_charset_name()"><a id="umap_charset_name"></a>umap_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set (in almost any format) and returns a string which contains a name for the character set that can be passed to Unicode::Map::new(). If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the argument string are not important.</p>

<pre><code>    $sCharset = umap_charset_name(&#39;hebrew&#39;);</code></pre>

</dd>
<dt id="umu8_charset_name()"><a id="umu8_charset_name"></a>umu8_charset_name()</dt>
<dd>

<p>This function takes a string containing the name of a character set (in almost any format) and returns a string which contains a name for the character set that can be passed to Unicode::MapUTF8::new(). If no valid character set name can be identified, then <code>undef</code> will be returned. The case and punctuation within the argument string are not important.</p>

<pre><code>    $sCharset = umu8_charset_name(&#39;windows-1251&#39;);</code></pre>

</dd>
</dl>

<h1 id="QUERY-ROUTINES"><a id="QUERY"></a>QUERY ROUTINES</h1>

<p>There is one function which can be used to obtain a list of all IANA-registered character set names.</p>

<dl>

<dt id="all_iana_charset_names()"><a id="all_iana_charset_names"></a><code>all_iana_charset_names()</code></dt>
<dd>

<p>Returns a list of all registered IANA character set names. The names are not in any particular order.</p>

</dd>
</dl>

<h1 id="CHARACTER-SET-NAME-ALIASING"><a id="CHARACTER"></a>CHARACTER SET NAME ALIASING</h1>

<p>This module supports several semi-private routines for specifying character set name aliases.</p>

<dl>

<dt id="add_iana_alias()"><a id="add_iana_alias"></a>add_iana_alias()</dt>
<dd>

<p>This function takes two strings: a new alias, and a target IANA Character Set Name (or another alias). It defines the new alias to refer to that character set name (or to the character set name to which the second alias refers).</p>

<p>Returns the target character set name of the successfully installed alias. Returns &#39;undef&#39; if the target character set name is not registered. Returns &#39;undef&#39; if the target character set name of the second alias is not registered.</p>

<pre><code>  I18N::Charset::add_iana_alias(&#39;my-alias1&#39; =&gt; &#39;Shift_JIS&#39;);</code></pre>

<p>With this code, &quot;my-alias1&quot; becomes an alias for the existing IANA character set name &#39;Shift_JIS&#39;.</p>

<pre><code>  I18N::Charset::add_iana_alias(&#39;my-alias2&#39; =&gt; &#39;sjis&#39;);</code></pre>

<p>With this code, &quot;my-alias2&quot; becomes an alias for the IANA character set name referred to by the existing alias &#39;sjis&#39; (which happens to be &#39;Shift_JIS&#39;).</p>

</dd>
<dt id="add_map8_alias()"><a id="add_map8_alias"></a>add_map8_alias()</dt>
<dd>

<p>This function takes two strings: a new alias, and a target Unicode::Map8 Character Set Name (or an existing alias to a Map8 name). It defines the new alias to refer to that mapping name (or to the mapping name to which the second alias refers).</p>

<p>If the first argument is a registered IANA character set name, then all aliases of that IANA character set name will end up pointing to the target Map8 mapping name.</p>

<p>Returns the target mapping name of the successfully installed alias. Returns &#39;undef&#39; if the target mapping name is not registered. Returns &#39;undef&#39; if the target mapping name of the second alias is not registered.</p>

<pre><code>  I18N::Charset::add_map8_alias(&#39;normal&#39; =&gt; &#39;ANSI_X3.4-1968&#39;);</code></pre>

<p>With the above statement, &quot;normal&quot; becomes an alias for the existing Unicode::Map8 mapping name &#39;ANSI_X3.4-1968&#39;.</p>

<pre><code>  I18N::Charset::add_map8_alias(&#39;normal&#39; =&gt; &#39;US-ASCII&#39;);</code></pre>

<p>With the above statement, &quot;normal&quot; becomes an alias for the existing Unicode::Map mapping name &#39;ANSI_X3.4-1968&#39; (which is what &quot;US-ASCII&quot; is an alias for).</p>

<pre><code>  I18N::Charset::add_map8_alias(&#39;IBM297&#39; =&gt; &#39;EBCDIC-CA-FR&#39;);</code></pre>

<p>With the above statement, &quot;IBM297&quot; becomes an alias for the existing Unicode::Map mapping name &#39;EBCDIC-CA-FR&#39;. As a side effect, all the aliases for &#39;IBM297&#39; (i.e. &#39;cp297&#39; and &#39;ebcdic-cp-fr&#39;) also become aliases for &#39;EBCDIC-CA-FR&#39;.</p>

</dd>
<dt id="add_umap_alias()"><a id="add_umap_alias"></a>add_umap_alias()</dt>
<dd>

<p>This function works identically to add_map8_alias() above, but operates on Unicode::Map encoding tables.</p>

</dd>
<dt id="add_libi_alias()"><a id="add_libi_alias"></a>add_libi_alias()</dt>
<dd>

<p>This function takes two strings: a new alias, and a target iconv Character Set Name (or existing iconv alias). It defines the new alias to refer to that character set name (or to the character set name to which the existing alias refers).</p>

<p>Returns the target conversion scheme name of the successfully installed alias. Returns &#39;undef&#39; if there is no such target conversion scheme or alias.</p>

<p>Examples:</p>

<pre><code>  I18N::Charset::add_libi_alias(&#39;my-chinese1&#39; =&gt; &#39;CN-GB&#39;);</code></pre>

<p>With this code, &quot;my-chinese1&quot; becomes an alias for the existing iconv conversion scheme &#39;CN-GB&#39;.</p>

<pre><code>  I18N::Charset::add_libi_alias(&#39;my-chinese2&#39; =&gt; &#39;EUC-CN&#39;);</code></pre>

<p>With this code, &quot;my-chinese2&quot; becomes an alias for the iconv conversion scheme referred to by the existing alias &#39;EUC-CN&#39; (which happens to be &#39;CN-GB&#39;).</p>

</dd>
<dt id="add_enco_alias()"><a id="add_enco_alias"></a>add_enco_alias()</dt>
<dd>

<p>This function takes two strings: a new alias, and a target Encode encoding Name (or existing Encode alias). It defines the new alias referring to that encoding name (or to the encoding to which the existing alias refers).</p>

<p>Returns the target encoding name of the successfully installed alias. Returns &#39;undef&#39; if there is no such encoding or alias.</p>

<p>Examples:</p>

<pre><code>  I18N::Charset::add_enco_alias(&#39;my-japanese1&#39; =&gt; &#39;jis0201-raw&#39;);</code></pre>

<p>With this code, &quot;my-japanese1&quot; becomes an alias for the existing encoding &#39;jis0201-raw&#39;.</p>

<pre><code>  I18N::Charset::add_enco_alias(&#39;my-japanese2&#39; =&gt; &#39;my-japanese1&#39;);</code></pre>

<p>With this code, &quot;my-japanese2&quot; becomes an alias for the encoding referred to by the existing alias &#39;my-japanese1&#39; (which happens to be &#39;jis0201-raw&#39; after the previous call).</p>

</dd>
</dl>

<h1 id="KNOWN-BUGS-AND-LIMITATIONS"><a id="KNOWN"></a>KNOWN BUGS AND LIMITATIONS</h1>

<ul>

<li><p>There could probably be many more aliases added (for convenience) to all the IANA names. If you have some specific recommendations, please email the author!</p>

</li>
<li><p>The only character set names which have a corresponding mapping in the Unicode::Map8 module are the character sets that Unicode::Map8 can convert.</p>

<p>Similarly, the only character set names which have a corresponding mapping in the Unicode::Map module are the character sets that Unicode::Map can convert.</p>

</li>
<li><p>In the current implementation, all tables are read in and initialized when the module is loaded, and then held in memory until the program exits. A &quot;lazy&quot; implementation (or a less-portable tied hash) might lead to a shorter startup time. Suggestions, patches, comments are always welcome!</p>

</li>
</ul>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<dl>

<dt id="Unicode::Map"><a id="Unicode"></a>Unicode::Map</dt>
<dd>

<p>Convert strings from various multi-byte character encodings to and from Unicode.</p>

</dd>
<dt id="Unicode::Map8"><a id="Unicode1"></a>Unicode::Map8</dt>
<dd>

<p>Convert strings from various 8-bit character encodings to and from Unicode.</p>

</dd>
<dt id="Jcode">Jcode</dt>
<dd>

<p>Convert strings among various Japanese character encodings and Unicode.</p>

</dd>
<dt id="Unicode::MapUTF8"><a id="Unicode2"></a>Unicode::MapUTF8</dt>
<dd>

<p>A wrapper around all three of these character set conversion distributions.</p>

</dd>
</dl>

<h1 id="AUTHOR">AUTHOR</h1>

<p>Martin &#39;Kingpin&#39; Thurn, <code>mthurn at cpan.org</code>, <a href="http://tinyurl.com/nn67z">http://tinyurl.com/nn67z</a>.</p>

<h1 id="LICENSE">LICENSE</h1>

<p>This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install I18N::Charset, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm I18N::Charset</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install I18N::Charset</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./I18N::Charset.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
